Night Owl 6/Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso/019a/rndup.zip/MANUAL.ASC

Text File | 1991-08-17 | 17KB | 395 lines

@MAIN HEAD = VP R<BS>OUNDUP<D>

@CREDITS =  by Peter Donnelly

@CREDITS = 1301 Ryan Street

@CREDITS = Victoria BC Canada V8T 4Y8

@SECTION HEAD = Introduction

VP<N>R<MS>OUNDUP<D> is an affordable, easy-to-use program that helps
you manage Xerox Ventura Publisher version 2 or 3 chapters and style
sheets. The program's main features:

@BULLET = Automatically catalogs chapters and style sheets in selected
directories or on the entire hard disk.

@BULLET = Cross-references chapters and style sheets so you can easily
identify a chapter's style sheet, or what chapters use a certain style
sheet.

@BULLET = Finds and deletes unused style sheets.

@BULLET = Lists style tags within a style sheet, with font and alignment
information.

@BULLET = Copies a tag from one style sheet to another.

@BULLET = Changes one typeface to another in every tag in a style
sheet.

@BULLET = Makes global changes to paragraph typography, e.g. to enable
automatic pair kerning in every tag.

@BULLET = Copies a chapter to another directory or an archive disk
and updates the chapter pointers; can copy the style sheet without
bringing along the width table.

@BULLET = Deletes a chapter and all associated files.

References to Ventura Publisher in this manual are to the GEM
edition. Names of dialog boxes etc. may differ in the Windows version.
VP<N>R<MS>OUNDUP<D> should work equally well with either edition of
Ventura.

@SECTION HEAD = The interface

The program uses a Turbo Vision interface that is very similar to
GEM and Microsoft Windows. It can be used with or without a mouse.

Most of the menu choices have shortcut function keys, which are shown
on the menus.

Menu choices and buttons can be activated by pressing <B>Alt<D> plus
the highlighted letter. In dialog boxes, clicking on <B>Cancel<D>
or the little box in the upper left corner, or striking the <B>Esc<D>
key, discards any changes made. Striking <B>Enter<D> activates the
highlighted button.

In lists, you can move the highlight with the scroll bar or the arrow
keys, or by clicking or dragging with the mouse. <B>Home<D> moves
the highlight to the top of the box and <B>End<D> to the bottom; <B>PgUp<D>
and <B>PgDn<D> move a new part of the list into the box; <B>Ctrl-PgUp<D>
and <B>Ctrl-PgDn<D> go to the top and bottom of the list. In most
lists you can select an item by double-clicking on it.

In dialog boxes, move from field to field with <B>Tab<D> and <B>Shift-Tab<D>,
or by clicking on the field or label with the mouse. If you're not
using a mouse, you can move the highlight from button to button or
from checkbox to checkbox with the arrow keys, and toggle checkboxes
with the space bar.

In input boxes, a block-shaped cursor indicates overtype mode and
an underline indicates insert mode. You can switch modes with the
<B>Ins<D> key. Highlight text by clicking on the field's label, by
double-clicking on the text in the box, or by dragging across selected
text with the mouse. The <B>Del<D> key deletes highlighted text; as
well, any highlighted text is deleted when you start typing in insert
mode.

Quit the program by striking <B>Alt-X<D> or through the <B>Program<D>
menu.

@SECTION HEAD = Installation and setup

Install VP<N>R<MS>OUNDUP<D> by copying ROUNDUP.EXE to any directory
on your hard drive.

If you are using a version of DOS earlier than 3.0, you must change
to the VP<N>R<MS>OUNDUP<D> home directory before calling the program;
otherwise you can call it from anywhere, as long as you provide DOS
with the path in the usual way.

@SUBHEAD = Set preferences

You may want to change the default colors under <B>Program: Preferences<193><D>.
The gray-scale option provides a somewhat more legible screen on the
full-page monitors often used with Ventura.

In the same dialog box, click on <B>Auto catalog<D> if you want the
file catalog to be recompiled automatically each time you run the
program.

@SUBHEAD = Set paths and make catalog

Before using the program you need to create a catalog of Ventura chapters
and style sheets. Refer to the following section for details.

@SECTION HEAD = Catalog menu

@SUBHEAD = Paths<193>

This menu choice allows you to specify the directories that will be
searched when VP<N>R<MS>OUNDUP<D> compiles its catalog of chapters
and style sheets. In the first two fields you can enter any number
of directories and subdirectories, separated by a semicolon, for a
total of up to 255 characters. If the length of the path exceeds the
width of the input box, an arrow will appear and you can scroll the
text by clicking on this arrow, or with the usual cursor-movement
keys.

To cause the program to search all subdirectories of a directory (to
any level), put a backslash and an asterisk after the directory name.

For example:

@COURIER = C:\*;D:\*

causes all of drives C and D to be searched; and

@COURIER = C:\TYPESET;C:\VENTURA\*;

causes the TYPESET directory, the VENTURA directory, and all subdirectories
within the VENTURA directory to be searched. Note that the final semicolon
is optional.

If you plan to use VP<N>R<MS>OUNDUP<D> to find and delete unused style
sheets, it's obviously wise to make certain that the chapter catalog
is comprehensive. The certainty that no stray chapters have been overlooked
is well worth the extra time spent in searching the entire disk rather
than just selected directories.

Before closing the dialog box, make sure the correct drive letter
is entered in the last field. This is the drive where the program
will look for \VENTURA\OUTPUT.WID in the event that it cannot find
the width table referenced by a style sheet. (If it is unable to find
a width table at all, you will not be able to see the typeface names
for the paragraph tags.) It is also the drive where it will look for
a style sheet referenced by a chapter when the reference does not
contain a drive letter.

The path settings are saved to disk when you quit the program and
automatically reloaded in your next session.

@SUBHEAD = Make

When you choose <B>Catalog: Make<D>, the program compiles a list of
files with the extensions <169>.STY<170> and <169>.CHP<170> in the
search path. Style sheets are checked for the Ventura version number,
so that STY files from other programs such as Microsoft Word are excluded.

The catalog files, STYLES.CAT and CHAPTERS.CAT, are in ASCII format
and can be printed through DOS or another program.

@SECTION HEAD = Chapters menu

@SUBHEAD = Find style sheet<193>

This menu pick brings up a list of all the chapters in the catalog.  To
find out what style sheet a chapter uses, highlight the name and click
on <B>OK<D>. If the filename that appears is in the style catalog,
you are offered the option of selecting the style sheet for examination
or processing.

@SUBHEAD = Delete<193>

To delete a chapter and all related files, highlight the name in the
catalog list and click on <B>OK<D>. You are now given the choice of
cancelling the deletion or going ahead with or without prompting.
If you select <B>Ask<D>, you are given the choice of not deleting
the style sheet and any external text or graphics files used by the
chapter, but the CHP, CAP, CIF, and VGR files will be deleted without
prompting. Be careful, as no checking is done to see if a style sheet
or other file is used by another chapter in the catalog.

When deleted, a chapter is removed from the list for this session
(as is its style sheet if you have chosen to delete it), but the catalog
is not updated. If you do not have <B>Auto catalog<D> selected, you
will be prompted to update the catalog when you quit the program.

@SUBHEAD = Copy<193>

To copy a catalogued chapter and all related files, highlight the
name and click on <B>OK<D>. In the <B>Destination directory<D> box,
enter a complete directory path but no chapter name, e.g.
<169>C:\VENTURA\REPORTS<170>. To copy to the root directory, enter the
drive as <169>A:\<170>; if you omit the backslash, the chapter will be
copied to the current directory. Clear the checkbox if you do not want to
copy the style sheet; in this case, the chapter will continue to point to
the style sheet in its original location.

You can copy any chapter, not just one in the catalog. To copy an
uncatalogued chapter, first select any file from the list, then change the
name of the <B>Chapter to copy<D> in the dialog box. This procedure can be
handy for transferring chapters from floppy disk.

The chapter copy feature works like Ventura's <B>Copy All<D>, but
with the following differences:

1.<+>All files that form part of the chapter are copied to the same
directory, except for the style sheet, which optionally can be left
where it is.

2.<+>The destination directory must already exist.

3.<+>Any existing files with the same names in the destination directory
are overwritten without warning.

4.<+>The width table is never copied.

5.<+>You cannot copy to the directory that already holds the CHP file.
(If you really want to get around this, in order to consolidate all
the chapter's files in a single directory, you can always copy to
another directory and then back again.)

If the program cannot find a text or graphics file referenced by the
chapter, it will warn you that the chapter may be incomplete. However,
it will not detect missing CAP or VGR files.

@SECTION HEAD = Styles menu

@SUBHEAD = Select style sheet<193>

This choice brings up a list of all style sheets in the catalog. To
select one for processing, highlight it and click on <B>Select<D>,
or double-click on the name.

The name of the selected style sheet appears on the bottom line of
the screen throughout the session.

@SUBHEAD = Where used<193>

Choose this to see a list of all chapters in the catalog that point
to the selected style sheet.

If there are no matches, you are offered the choice of deleting the
style sheet. If you delete it, it is removed from the list for this
session but remains in the disk catalog until the next update. If
you do not have automatic cataloguing turned on, you will be prompted
to update the catalog when you quit the program.

@SUBHEAD = Find unused<193>

This menu choice cross-references all chapters and all style sheets
in the catalog and then displays a list of unused style sheets. Highlight
the name of any style sheet you wish to delete and click on the <B>Delete<D>
button. If you wish to examine the list of tags in the style sheet
first, make it the active style sheet by clicking on <B>Select<D>
or by double-clicking on the name, then choose <B>Tags: View & Copy<193><D>.
Then, if you still wish to delete the file, you can choose <B>Styles:
Where used<193><D> to bring up the appropriate prompt.

@SECTION HEAD = Tags menu

@SUBHEAD = View & Copy<193>

This displays a list of all paragraph tag names in the selected style
sheet, together with some additional information about the tags and
about the style sheet itself.

The typeface names are taken from the width table referenced by the
style sheet, or from the default OUTPUT.WID if the referenced width
table could not be found. (The name of the width table from which
the typeface names are taken is given at the bottom of the dialog
box.) If no width table could be found, or if a typeface used in a
tag is not found in the width table, the name of the typeface appears
as a series of question marks.

To the left of each typeface name is the number used by Ventura to
identify the face. At the right, the size of the tag font is given
in points. The last item on the line describes the paragraph alignment.

To copy a tag from the currently selected style sheet to another one
in the catalog, highlight the tag and click on <B>Copy.<D> Now select
another style sheet from the list that appears. If the tag name already
exists in the destination style sheet, you are prompted either to
replace the existing tag (by clicking <B>Yes<D>) or to create a new
tag with a different name (by clicking <B>Rename<D>). If you select
<B>Cancel,<D> the tag will not be copied.

@NOTE = <B>Note on face ID and sizes. <D>Those who use Ventura with
more than one printer may want to read this note; others can safely
skip it.

@NOTE = If you switch between scalable and bitmapped fonts, you may
occasionally see a non-existent half-point size listed for a bitmapped
font, e.g. 10.5 instead of 10. This is because the style sheet <169>remembers<170>
half-points even when a font is changed to a face that exists only
in whole-number sizes. Ventura ignores the fraction when using a non-scalable
font, and you can do the same.

@NOTE = It is useful to know the typeface ID so that you have some
idea of what to expect when transferring a chapter between printers.
The typeface ID is the constant in a style sheet, whereas the typeface
name and even the actual face may change depending on the width table
and the printer used. For example, face No. 2 is Univers on a LaserJet<N>III,
Helvetica on a PostScript printer, and Swiss on a printer using Bitstream
fonts.

@NOTE = By the same token, faces that might be expected to be equivalent
may not have the same ID. For instance, the Ventura driver supplied
by Pacific Data Products with its Complete Font Library Cartridge
does not assign the normal Palatino ID to the Palacio face, with the
result that a paragraph that prints out in Palacio on the LaserJet
will not be in Palatino on a PostScript printer. (The technically
minded can fix this by altering the face ID in the VFM and CNF files.)

@SUBHEAD = Faces<193>

The <B>Faces<D> dialog lets you change one typeface to another throughout
the selected style sheet.

You see two lists of typeface names, with their identity numbers.
On the left are all the faces used in the style sheet; on the right
are all faces available in the width table, in the same order as in
the Ventura font dialog.

Select a face from each list by clicking on it. (If you're not using
a mouse, you can move the highlight from one list to the other with
the <B>Tab<D> key.) When you close the dialog and confirm that you
want to update the style sheet, the typeface selected from the left-hand
list will be changed to the one selected from the right-hand list,
in every tag where it occurs. Font attributes<|><197><|>italics, boldface
etc.<|><197><|>are not affected. The point size remains the same for
each tag, unless of course that size does not exist for the new typeface,
in which case Ventura will change it the next time the style sheet
is used.

If the <B>Tags: Faces<193><D> pick is not available even though a
style sheet has been selected, it means that no width table was found
for the style sheet.

@SUBHEAD = Typography<193>

Through this menu choice you can alter certain typographical features
of every tag.

The default settings in the dialog box are taken from the Body Text
tag in the selected style sheet. If you click on <B>OK<D> without
changing any of the settings, all tags will be made to conform to
the Body Text settings.

For each typographical feature you have the option of leaving the
setting <B>As<N>is<D>, meaning that the setting will not be changed
in any tag. Thus you can standardize hyphenation, for example, without
disturbing individual settings for tracking or other features.

To turn hyphenation on, select <B>Method<N>#1<D> or <B>Method<N>#2<D>.
These methods refer to the two selections offered under VP-GEM's <B>Paragraph:
Alignment: Hyphenation<D> menu, e.g. USDICT and USENGLSH. Normally
you will want to choose Method<N>#1. (Users of the Windows edition
should leave hyphenation <B>As<N>is.<D>)

If you turn on letter spacing, enter a value in the input box below
the buttons. This value is ignored if you have selected <B>As<N>is<D>
or <B>Off.<D>

To change tracking in every paragraph, select <B>Tighter<D> or <B>Looser<D>
and enter a value in the input box below the buttons. This value is
ignored if you have selected <B>As<N>is<D>.

If you want to make a global change to the value for any of the space
widths, you must enter the desired value in the input box at the right
and ensure that there is an X in the check box. An unchecked box is
equivalent to a choice of <B>As<N>is<D> for that space width.

@SECTION HEAD = Technical support

The author is pleased to respond to any questions, bug reports, or
requests for new features when these come from registered owners of
the program. If you have not already registered, please enclose a
check or money order for $25 with your letter.

Peter Donnelly can also be reached on CompuServe (76217,2177).

@SECTION HEAD = Acknowledgments

Ventura Publisher is a trademark of Ventura Software Inc., whose assistance
is gratefully acknowledged.

VP<N>R<MS>OUNDUP<D> was developed with Turbo Pascal and Turbo Vision,
products of Borland International.